docs(website): add Use Cases section with Light Wallets, Bridges; add Case Studies section with Daedalus by dalibran · Pull Request #3200 · input-output-hk/mithril

dalibran · 2026-04-14T18:35:53Z

Summary

Adds a Use Cases dropdown to the navbar, positioned between Manual and Protocol
Renames navbar labels: "User manual" → "Manual", "About Mithril" → "Protocol"
Adds a Wallets use case page (/use-cases/wallets) covering two audiences:
- Wallet developers: value prop, how Mithril fits existing stack, integration guide, Discord CTA
- Wallet users: plain-language explanation of what Mithril-enabled wallets mean for them
Includes a caution admonition noting protocol security scales with SPO participation — the client is production-ready but full production wallet deployment should wait for sufficient stake coverage
Adds useCasesSideBar to sidebars.js and version-maintained-sidebars.json
Mirrors new docs into versioned_docs/version-maintained/ to support the version dropdown

Notes for reviewers

The caution admonition wording around stake participation thresholds is intentionally vague — flagging for technical review to sharpen the specific threshold language
The version dropdown label/ordering is a separate open question flagged for future discussion

Test plan

Verify Use Cases dropdown appears in navbar and links correctly
Verify Wallets page renders correctly in both current and maintained versions
Verify caution and note admonitions render correctly
Verify Discord button opens correct channel
Check right-side TOC shows correct heading hierarchy

🤖 Generated with Claude Code

github-actions · 2026-04-14T18:57:15Z

Test Results

5 files ± 0 203 suites ±0 52m 10s ⏱️ - 3h 47m 2s
3 059 tests - 65 3 059 ✅ - 65 0 💤 ±0 0 ❌ ±0
10 458 runs - 74 10 458 ✅ - 74 0 💤 ±0 0 ❌ ±0

Results for commit 61bf30c. ± Comparison against base commit 7e5acd5.

This pull request removes 65 tests.

mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::index_out_of_bounds
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::index_too_large_for_circuit_range
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::indices_not_increasing
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::leaf_merkle_path_mismatch
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::leaf_swap_keep_merkle_path
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::leaf_wrong_verification_key
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::merkle_path_corrupt_sibling
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::merkle_path_flip_position
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::merkle_path_length_long
mithril-stm ‑ circuits::halo2::tests::golden::cases::negative::slow::merkle_path_length_short
…

♻️ This comment has been updated with latest results.

jpraynaud · 2026-05-13T15:02:54Z

+
+## How Mithril helps
+
+Fresh installations of Daedalus now download a Mithril-certified snapshot of the Cardano node database and restore it locally, rather than replaying the chain. The snapshot's integrity is verified against the Mithril certificate chain, anchored in Cardano's stake distribution — so users get the same trust guarantees as a chain-replayed node, without the wait.


Maybe you can specify how long it takes with Mithril: usually 30min to 1h depending on hardware and internet connection.

- Add Use Cases dropdown to navbar (between Manual and Protocol) - Rename navbar labels: "User manual" → "Manual", "About Mithril" → "Protocol" - Add Wallets use case page covering developer and end-user audiences - Add useCasesSideBar to sidebars.js and versioned sidebars - Wallet page includes: security caution admonition, integration guide, Discord CTA button, and note on server membership Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Wrap button text in a span to prevent MDX from injecting a paragraph element with inherited margin-bottom, and use explicit height on the anchor for reliable vertical centering. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

- Rename page/sidebar label to "Light wallets" (sentence case) - Move Use Cases dropdown to end of left navbar - Remove unused spoCta note about IOG Discord membership - Update browser support paragraph with compatibility link, example, and Rust crate link - Remove "For wallet developers" title casing Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Remove specific security caveat content from the caution admonition, replacing it with a neutral info admonition pointing to the Protocol security page. Drop the Swift/Kotlin mobile bindings paragraph. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Adds a Bridges page under Use Cases following the same structure as Light wallets. Wires it into the Use Cases navbar dropdown and mirrors the page into the maintained docs version. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Introduce a Case Studies docs section with a Daedalus entry covering Mithril-based initial sync, including navbar dropdown, sidebar, and wordmark styling. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>

Replace the standalone Light Wallets page with a Wallets landing that introduces both wallet shapes and surfaces the Light wallets integration guide and the Daedalus case study as cards. Merge the separate Case Studies section into Use Cases so the Daedalus study lives under Wallets in the sidebar. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…framing Apply lead-dev review feedback: promote Rust client library and CLI as the primary integration path (with WASM scoped to browser-facing components), rework the finality framing so it's clear the bridge sets its own confirmation threshold under both current and upcoming Mithril certification, tighten the "compromised provider" clause to name the concrete consequence, and clarify the user-facing "aggregator" term with a 1inch example. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Add the with-Mithril sync figure (roughly 30 minutes to an hour, depending on hardware and connection) to the "How Mithril helps" section, and replace em dashes with commas across the page for a less stylized read. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

dalibran self-assigned this Apr 14, 2026

dalibran requested review from jpraynaud and olgahryniuk April 14, 2026 18:36

dalibran temporarily deployed to testing-preview April 14, 2026 18:59 — with GitHub Actions Inactive

jpraynaud requested changes Apr 15, 2026

View reviewed changes

olgahryniuk approved these changes Apr 17, 2026

View reviewed changes

dalibran mentioned this pull request Apr 17, 2026

Improving Mithril Documentation #3013

Open

dalibran linked an issue Apr 17, 2026 that may be closed by this pull request

Improving Mithril Documentation #3013

Open

dalibran temporarily deployed to testing-preview April 17, 2026 19:59 — with GitHub Actions Inactive

jpraynaud reviewed Apr 24, 2026

View reviewed changes

Comment thread docs/website/root/use-cases/wallets/light-wallets.mdx

dalibran changed the title ~~docs(website): add Use Cases section with Wallet integration guide~~ docs(website): add Use Cases section with Light Wallets, Bridges; add Case Studies section with Daedalus May 13, 2026

jpraynaud reviewed May 13, 2026

View reviewed changes

dalibran and others added 16 commits May 20, 2026 15:35

docs(website): fix prettier formatting on wallet use case pages

7582fe1

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Update docs/website/root/use-cases/wallets.mdx

90ae569

Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>

Update docs/website/root/use-cases/wallets.mdx

b9aab97

Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>

Update docs/website/root/use-cases/wallets.mdx

1828f71

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

5994434

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

c7d80b7

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

ebdff23

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

2239a8e

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

fbb0d4d

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

c867cbd

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

Update docs/website/root/use-cases/wallets.mdx

fe0790e

Co-authored-by: olgahryniuk <67585499+olgahryniuk@users.noreply.github.com>

dalibran and others added 4 commits May 20, 2026 15:35

docs(website): add Daedalus case study page

69a3bd4

Introduce a Case Studies docs section with a Daedalus entry covering Mithril-based initial sync, including navbar dropdown, sidebar, and wordmark styling. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Update docs/website/root/case-studies/daedalus.mdx

30aee05

Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>

Update docs/website/root/use-cases/bridges.mdx

b42f3f3

Co-authored-by: Jean-Philippe Raynaud <jp.raynaud@gmail.com>

dalibran force-pushed the docs/use-cases branch from 1166231 to 65dccb7 Compare May 20, 2026 06:39

dalibran requested review from Alenar and turmelclem as code owners May 20, 2026 06:39

dalibran removed request for Alenar and turmelclem May 20, 2026 06:48

dalibran and others added 2 commits May 20, 2026 16:25


		## How Mithril helps

		Fresh installations of Daedalus now download a Mithril-certified snapshot of the Cardano node database and restore it locally, rather than replaying the chain. The snapshot's integrity is verified against the Mithril certificate chain, anchored in Cardano's stake distribution — so users get the same trust guarantees as a chain-replayed node, without the wait.

Conversation

dalibran commented Apr 14, 2026

Summary

Notes for reviewers

Test plan

Uh oh!

github-actions Bot commented Apr 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test Results

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jpraynaud May 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions Bot commented Apr 14, 2026 •

edited

Loading